HAL GFXTIM constants migration

This section provides information about the HAL GFXTIM constants migration.

HAL GFXTIM absolute time identifiers constants

HAL1

HAL2



#define GFXTIM_ABSOLUTE_LINE_TIME
#define GFXTIM_ABSOLUTE_FRAME_TIME
#define GFXTIM_ABSOLUTE_GLOBAL_TIME
typedef enum
{
  HAL_GFXTIM_ABSTIM_LINE_COUNTER,
  HAL_GFXTIM_ABSTIM_FRAME_COUNTER,
  HAL_GFXTIM_ABSTIM_LINE_FRAME_COUNTER,
} hal_gfxtim_abstim_counter_t;

Related concepts:


HAL GFXTIM absolute line comparators constants

HAL1

HAL2



#define GFXTIM_ABSOLUTE_LINE_COMPARE1
#define GFXTIM_ABSOLUTE_LINE_COMPARE2
typedef enum
{
  HAL_GFXTIM_ABSTIM_LINE_COMP_1,
  HAL_GFXTIM_ABSTIM_LINE_COMP_2
} hal_gfxtim_abstim_line_comp_t;

Related concepts:


HAL GFXTIM error codes constants

HAL1

HAL2

#define GFXTIM_ERROR_INVALID_CALLBACK
#define GFXTIM_ERROR_NONE
#define GFXTIM_ERROR_STATE

Removed; these kinds of logical errors are reported by the direct function return.

Related concept:


HAL GFXTIM event generator indices constants

HAL1

HAL2



#define GFXTIM_EVENT_GENERATOR_1
#define GFXTIM_EVENT_GENERATOR_2
#define GFXTIM_EVENT_GENERATOR_3
#define GFXTIM_EVENT_GENERATOR_4
typedef enum
{
   HAL_GFXTIM_EVENTGEN_EVENT_1,
   HAL_GFXTIM_EVENTGEN_EVENT_2,
   HAL_GFXTIM_EVENTGEN_EVENT_3,
   HAL_GFXTIM_EVENTGEN_EVENT_4
 } hal_gfxtim_eventgen_event_t;

Related concepts:


HAL GFXTIM frame clock counter sources constants

HAL1

HAL2



#define GFXTIM_FCC_CLK_SRC_DISABLE
#define GFXTIM_FCC_CLK_SRC_LCC_UNDERFLOW
#define GFXTIM_FCC_CLK_SRC_HSYNC_RISING
#define GFXTIM_FCC_CLK_SRC_HSYNC_FALLING
#define GFXTIM_FCC_CLK_SRC_VSYNC_RISING
#define GFXTIM_FCC_CLK_SRC_VSYNC_FALLING
#define GFXTIM_FCC_CLK_SRC_TE_RISING
#define GFXTIM_FCC_CLK_SRC_TE_FALLING
typedef enum
{
  HAL_GFXTIM_CLKGEN_FCNT_DISABLE,
  HAL_GFXTIM_CLKGEN_FCNT_LINE_UNDERFLOW,
  HAL_GFXTIM_CLKGEN_FCNT_HSYNC_RISING,
  HAL_GFXTIM_CLKGEN_FCNT_HSYNC_FALLING,
  HAL_GFXTIM_CLKGEN_FCNT_VSYNC_RISING,
  HAL_GFXTIM_CLKGEN_FCNT_VSYNC_FALLING,
  HAL_GFXTIM_CLKGEN_FCNT_TE_RISING,
  HAL_GFXTIM_CLKGEN_FCNT_TE_FALLING
} hal_gfxtim_clkgen_frame_count_src_t;

Related concepts:


HAL GFXTIM frame clock counter hardware reload sources constants

HAL1

HAL2



#define GFXTIM_FCC_HW_RELOAD_SRC_NONE
#define GFXTIM_FCC_HW_RELOAD_SRC_LCC_UNDERFLOW
#define GFXTIM_FCC_HW_RELOAD_SRC_HSYNC_RISING
#define GFXTIM_FCC_HW_RELOAD_SRC_HSYNC_FALLING
#define GFXTIM_FCC_HW_RELOAD_SRC_VSYNC_RISING
#define GFXTIM_FCC_HW_RELOAD_SRC_VSYNC_FALLING
#define GFXTIM_FCC_HW_RELOAD_SRC_TE_RISING
#define GFXTIM_FCC_HW_RELOAD_SRC_TE_FALLING
typedef enum
{
  HAL_GFXTIM_CLKGEN_FCNT_NO_RELOAD,
  HAL_GFXTIM_CLKGEN_FCNT_LINE_UNDERFLOW_RELOAD,
  HAL_GFXTIM_CLKGEN_FCNT_HSYNC_RISING_RELOAD,
  HAL_GFXTIM_CLKGEN_FCNT_HSYNC_FALLING_RELOAD,
  HAL_GFXTIM_CLKGEN_FCNT_VSYNC_RISING_RELOAD,
  HAL_GFXTIM_CLKGEN_FCNT_VSYNC_FALLING_RELOAD,
  HAL_GFXTIM_CLKGEN_FCNT_TE_RISING_RELOAD,
  HAL_GFXTIM_CLKGEN_FCNT_TE_FALLING_RELOAD
} hal_gfxtim_clkgen_frame_count_reload_src_t;

Related concepts:


HAL GFXTIM status flags constants

HAL1

HAL2

#define GFXTIM_FLAG_AFCC1
#define GFXTIM_FLAG_AFCO
#define GFXTIM_FLAG_ALCC1
#define GFXTIM_FLAG_ALCC2
#define GFXTIM_FLAG_ALCO
#define GFXTIM_FLAG_EV1
#define GFXTIM_FLAG_EV2
#define GFXTIM_FLAG_EV3
#define GFXTIM_FLAG_EV4
#define GFXTIM_FLAG_RFC1R
#define GFXTIM_FLAG_RFC2R
#define GFXTIM_FLAG_TE
#define GFXTIM_FLAG_WDGA
#define GFXTIM_FLAG_WDGP
#define LL_GFXTIM_FLAG_AFCC1
#define LL_GFXTIM_FLAG_AFCO
#define LL_GFXTIM_FLAG_ALCC1
#define LL_GFXTIM_FLAG_ALCC2
#define LL_GFXTIM_FLAG_ALCO
#define LL_GFXTIM_FLAG_EV1
#define LL_GFXTIM_FLAG_EV2
#define LL_GFXTIM_FLAG_EV3
#define LL_GFXTIM_FLAG_EV4
#define LL_GFXTIM_FLAG_RFC1R
#define LL_GFXTIM_FLAG_RFC2R
#define LL_GFXTIM_FLAG_TE
#define LL_GFXTIM_FLAG_WDGA
#define LL_GFXTIM_FLAG_WDGP
#define LL_GFXTIM_FLAG_ALL

Related concept:


HAL GFXTIM frame clock calibration enable/disable constants

HAL1

HAL2

In HAL1, the GFXTIM frame clock calibration is a member of the GFXTIM_ClockGeneratorConfigTypeDef structure.

In HAL2, the GFXTIM frame clock calibration is handled through dedicated functions within the HAL layer.

#define GFXTIM_FRAME_CLK_CALIB_DISABLE
#define GFXTIM_FRAME_CLK_CALIB_ENABLE
HAL_GFXTIM_CLKGEN_DisableFrameClkCalibOutput()
HAL_GFXTIM_CLKGEN_EnableFrameClkCalibOutput()

HAL GFXTIM counter clock generator identifier constants

HAL1

HAL2



#define GFXTIM_LINE_CLK_COUNTER
#define GFXTIM_FRAME_CLK_COUNTER
typedef enum
{
  HAL_GFXTIM_CLKGEN_LINE_CLK_COUNTER,
  HAL_GFXTIM_CLKGEN_FRAME_CLK_COUNTER,
  HAL_GFXTIM_CLKGEN_FRAME_LINE_CLK_COUNTER
} hal_gfxtim_clkgen_counter_t;

Related concepts:


HAL GFXTIM frame clock sources constants

HAL1

HAL2



#define GFXTIM_FRAME_CLK_SRC_LCC_UNDERFLOW
#define GFXTIM_FRAME_CLK_SRC_FCC_UNDERFLOW
#define GFXTIM_FRAME_CLK_SRC_HSYNC_RISING
#define GFXTIM_FRAME_CLK_SRC_HSYNC_FALLING
#define GFXTIM_FRAME_CLK_SRC_VSYNC_RISING
#define GFXTIM_FRAME_CLK_SRC_VSYNC_FALLING
#define GFXTIM_FRAME_CLK_SRC_TE_RISING
#define GFXTIM_FRAME_CLK_SRC_TE_FALLING
typedef enum
{
   HAL_GFXTIM_CLKGEN_FRAME_LCNT_UNDERFLOW,
   HAL_GFXTIM_CLKGEN_FRAME_FCNT_UNDERFLOW,
   HAL_GFXTIM_CLKGEN_FRAME_HSYNC_RISING,
   HAL_GFXTIM_CLKGEN_FRAME_HSYNC_FALLING,
   HAL_GFXTIM_CLKGEN_FRAME_VSYNC_RISING,
   HAL_GFXTIM_CLKGEN_FRAME_VSYNC_FALLING,
   HAL_GFXTIM_CLKGEN_FRAME_TE_RISING,
   HAL_GFXTIM_CLKGEN_FRAME_TE_FALLING
} hal_gfxtim_clkgen_frame_clk_src_t;

Related concepts:


HAL GFXTIM frame events constants

HAL1

HAL2



#define GFXTIM_FRAME_EVENT_NONE
#define GFXTIM_FRAME_EVENT_AFC_OVERFLOW
#define GFXTIM_FRAME_EVENT_AFC_COMPARE
#define GFXTIM_FRAME_EVENT_RFC1_RELOAD
#define GFXTIM_FRAME_EVENT_RFC2_RELOAD
typedef enum
{
  HAL_GFXTIM_EVENTGEN_FRAME_NONE,
  HAL_GFXTIM_EVENTGEN_ABS_FCNT_OVERFLOW,
  HAL_GFXTIM_EVENTGEN_ABS_FCNT_COMP,
  HAL_GFXTIM_EVENTGEN_REL_FCNT_1_RELOAD,
  HAL_GFXTIM_EVENTGEN_REL_FCNT_2_RELOAD
} hal_gfxtim_eventgen_frame_src_t;

Related concepts:


HAL GFXTIM interrupt enable/disable constants

HAL1

HAL2

In HAL1, the interrupt is a member of the configuration structure for each functional block (absolute timer, relative timer, tearing effect detection, event generator and watchdog counter).

In HAL2, the interrupt is managed directly through the start APIs of each functional block.

#define GFXTIM_IT_DISABLE

#define GFXTIM_IT_ENABLE
#define HAL_GFXTIM_NONE_IT

#define HAL_GFXTIM_ABSTIM_LINE_COMP1_IT
#define HAL_GFXTIM_ABSTIM_LINE_COMP2_IT
#define HAL_GFXTIM_ABSTIM_LINE_COUNT_OVERFLOW_IT
#define HAL_GFXTIM_ABSTIM_LINE_ALL_IT
#define HAL_GFXTIM_ABSTIM_FRAME_COMP_IT
#define HAL_GFXTIM_ABSTIM_FRAME_COUNT_OVERFLOW_IT
#define HAL_GFXTIM_ABSTIM_FRAME_ALL_IT
#define HAL_GFXTIM_RELTIM_COUNT_IT
#define HAL_GFXTIM_TEARING_EFFECT_IT
#define HAL_GFXTIM_EVENTGEN_EVENT_IT
#define HAL_GFXTIM_WDG_PREALARM_IT
#define HAL_GFXTIM_WDG_ALARM_IT
#define HAL_GFXTIM_WDG_ALL_IT

For more details, see HAL GFXTIM initialization type definition, HAL GFXTIM absolute timer configuration type definition, HAL GFXTIM relative timer configuration type definition, HAL GFXTIM event generator configuration type definition, HAL GFXTIM watchdog configuration type definition.


HAL GFXTIM line clock counter clock sources constants

HAL1

HAL2



#define GFXTIM_LCC_CLK_SRC_DISABLE
#define GFXTIM_LCC_CLK_SRC_SYSCLOCK
typedef enum
{
  HAL_GFXTIM_CLKGEN_LINE_COUNT_NONE,
  HAL_GFXTIM_CLKGEN_LINE_COUNT_GFXTIMHCLK
} hal_gfxtim_clkgen_line_count_src_t;

Related concepts:


HAL GFXTIM line clock counter hardware reload sources constants

HAL1

HAL2



#define GFXTIM_LCC_HW_RELOAD_SRC_NONE
#define GFXTIM_LCC_HW_RELOAD_SRC_FCC_UNDERFLOW
#define GFXTIM_LCC_HW_RELOAD_SRC_HSYNC_RISING
#define GFXTIM_LCC_HW_RELOAD_SRC_HSYNC_FALLING
#define GFXTIM_LCC_HW_RELOAD_SRC_VSYNC_RISING
#define GFXTIM_LCC_HW_RELOAD_SRC_VSYNC_FALLING
#define GFXTIM_LCC_HW_RELOAD_SRC_TE_RISING
#define GFXTIM_LCC_HW_RELOAD_SRC_TE_FALLING
typedef enum
{
  HAL_GFXTIM_CLKGEN_LCNT_NO_RELOAD,
  HAL_GFXTIM_CLKGEN_LCNT_FRAME_UNDERFLOW_RELOAD,
  HAL_GFXTIM_CLKGEN_LCNT_HSYNC_RISING_RELOAD,
  HAL_GFXTIM_CLKGEN_LCNT_HSYNC_FALLING_RELOAD,
  HAL_GFXTIM_CLKGEN_LCNT_VSYNC_RISING_RELOAD,
  HAL_GFXTIM_CLKGEN_LCNT_VSYNC_FALLING_RELOAD,
  HAL_GFXTIM_CLKGEN_LCNT_TE_RISING_RELOAD,
  HAL_GFXTIM_CLKGEN_LCNT_TE_FALLING_RELOAD
} hal_gfxtim_clkgen_line_count_reload_src_t;

Related concepts:


HAL GFXTIM line clock calibration enable/disable constants

HAL1

HAL2

In HAL1, the GFXTIM line clock calibration is a member of the GFXTIM_ClockGeneratorConfigTypeDef structure.

In HAL2, the GFXTIM line clock calibration is managed by unitary functions in the HAL layer.

#define GFXTIM_LINE_CLK_CALIB_DISABLE
#define GFXTIM_LINE_CLK_CALIB_ENABLE
HAL_GFXTIM_CLKGEN_DisableLineClkCalibOutput()
HAL_GFXTIM_CLKGEN_EnableLineClkCalibOutput()

HAL GFXTIM line clock source and counter constants

HAL1

HAL2



#define GFXTIM_LINE_CLK_SRC_LCC_UNDERFLOW
#define GFXTIM_LINE_CLK_SRC_FCC_UNDERFLOW
#define GFXTIM_LINE_CLK_SRC_HSYNC_RISING
#define GFXTIM_LINE_CLK_SRC_HSYNC_FALLING
#define GFXTIM_LINE_CLK_SRC_VSYNC_RISING
#define GFXTIM_LINE_CLK_SRC_VSYNC_FALLING
#define GFXTIM_LINE_CLK_SRC_TE_RISING
#define GFXTIM_LINE_CLK_SRC_TE_FALLING
typedef enum
{
  HAL_GFXTIM_CLKGEN_LINE_LCNT_UNDERFLOW,
  HAL_GFXTIM_CLKGEN_LINE_FCNT_UNDERFLOW,
  HAL_GFXTIM_CLKGEN_LINE_HSYNC_RISING,
  HAL_GFXTIM_CLKGEN_LINE_HSYNC_FALLING,
  HAL_GFXTIM_CLKGEN_LINE_VSYNC_RISING,
  HAL_GFXTIM_CLKGEN_LINE_VSYNC_FALLING,
  HAL_GFXTIM_CLKGEN_LINE_TE_RISING,
  HAL_GFXTIM_CLKGEN_LINE_TE_FALLING
} hal_gfxtim_clkgen_line_clk_src_t;

Related concepts:


HAL GFXTIM line event identifiers constants

HAL1

HAL2



#define GFXTIM_LINE_EVENT_NONE
#define GFXTIM_LINE_EVENT_ALC_OVERFLOW
#define GFXTIM_LINE_EVENT_TE
#define GFXTIM_LINE_EVENT_ALC1_COMPARE
#define GFXTIM_LINE_EVENT_ALC2_COMPARE
typedef enum
{
  HAL_GFXTIM_EVENTGEN_LINE_NONE,
  HAL_GFXTIM_EVENTGEN_ABS_LCNT_OVERFLOW,
  HAL_GFXTIM_EVENTGEN_TEARING_EFFECT,
  HAL_GFXTIM_EVENTGEN_ABS_LCNT_1_COMP,
  HAL_GFXTIM_EVENTGEN_ABS_LCNT_2_COMP
} hal_gfxtim_eventgen_line_src_t;

Related concepts:


HAL GFXTIM operating modes constants

HAL1

HAL2

In HAL1 counter mode is a member of GFXTIM_RelativeTimerConfigTypeDef structure

#define GFXTIM_MODE_CONTINUOUS




#define GFXTIM_MODE_ONE_SHOT

Removed; In HAL2, the relative counter mode is directly managed by the HAL relative timer start API, which selects the appropriate mode (continuous or one-shot)


hal_status_t HAL_GFXTIM_RELTIM_StartContinuous(hal_gfxtim_handle_t *hgfxtim,
                                               hal_gfxtim_reltim_counter_t counter,
                                               uint32_t autoreload_val,
                                               uint32_t interrupt)

hal_status_t HAL_GFXTIM_RELTIM_StartOneShot(hal_gfxtim_handle_t *hgfxtim,
                                            hal_gfxtim_reltim_counter_t counter,
                                            uint32_t autoreload_val,
                                            uint32_t interrupt)

For more details, refer to HAL GFXTIM relative timer configuration type definition


HAL GFXTIM relative timer indices constants

HAL1

HAL2



#define GFXTIM_RELATIVE_TIMER1
#define GFXTIM_RELATIVE_TIMER2
typedef enum
{
  HAL_GFXTIM_RELTIM_COUNTER_1,
  HAL_GFXTIM_RELTIM_COUNTER_2
} hal_gfxtim_reltim_counter_t;

Related concepts:


HAL GFXTIM synchronization sources constants

HAL1

HAL2

In HAL1, the synchronization source is member of GFXTIM_InitTypeDef. It provides all possible interconnections sources.

In HAL2, hal_gfxtim_sync_src_t provides only the connected synchronization source. It is available in some STM32 devices. For example, in STM32U5 this enumeration is not available because the LTDC is the only connected synchronization source.



#define GFXTIM_SYNC_SRC_HSYNC_VSYNC_0
#define GFXTIM_SYNC_SRC_HSYNC_VSYNC_1
#define GFXTIM_SYNC_SRC_HSYNC_VSYNC_2
#define GFXTIM_SYNC_SRC_HSYNC_VSYNC_3
typedef enum
{
  HAL_GFXTIM_SYNC_SRC_LTDC,
  HAL_GFXTIM_SYNC_SRC_DCMIPP_P0

} hal_gfxtim_sync_src_t;

HAL GFXTIM tearing effect rising/falling edge detection constants

HAL1

HAL2



#define GFXTIM_TE_RISING_EDGE
#define GFXTIM_TE_FALLING_EDGE
 typedef enum
 {
   HAL_GFXTIM_TEARING_EFFECT_RISING_EDGE,
   HAL_GFXTIM_TEARING_EFFECT_FALLING_EDGE
} hal_gfxtim_tearing_effect_polarity_t;

Related concepts:


HAL GFXTIM tearing effect source constants

HAL1

HAL2



#define GFXTIM_TE_SRC_GPIO
#define GFXTIM_TE_SRC_HSYNC
#define GFXTIM_TE_SRC_VSYNC


#define GFXTIM_TE_SRC_ITE
typedef enum
{
  HAL_GFXTIM_TEARING_EFFECT_GPIO,
  HAL_GFXTIM_TEARING_EFFECT_HSYNC,
  HAL_GFXTIM_TEARING_EFFECT_VSYNC
} hal_gfxtim_tearing_effect_src_t;

Removed; the internal tearing effect is represented by a reserved bit field and is not implemented in HAL2.

Related concepts:


HAL GFXTIM watchdog clock sources constants

HAL1

HAL2



#define GFXTIM_WATCHDOG_CLK_SRC_LINE_CLK
#define GFXTIM_WATCHDOG_CLK_SRC_FRAME_CLK
#define GFXTIM_WATCHDOG_CLK_SRC_HSYNC_RISING
#define GFXTIM_WATCHDOG_CLK_SRC_HSYNC_FALLING
#define GFXTIM_WATCHDOG_CLK_SRC_VSYNC_RISING
#define GFXTIM_WATCHDOG_CLK_SRC_VSYNC_FALLING
#define GFXTIM_WATCHDOG_CLK_SRC_TE_RISING
#define GFXTIM_WATCHDOG_CLK_SRC_TE_FALLING
#define GFXTIM_WATCHDOG_CLK_SRC_EVENT_1
#define GFXTIM_WATCHDOG_CLK_SRC_EVENT_2
#define GFXTIM_WATCHDOG_CLK_SRC_EVENT_3
#define GFXTIM_WATCHDOG_CLK_SRC_EVENT_4
typedef enum
{
  HAL_GFXTIM_WDG_CLK_LINE_CLK,
  HAL_GFXTIM_WDG_CLK_FRAME_CLK,
  HAL_GFXTIM_WDG_CLK_HSYNC_RISING,
  HAL_GFXTIM_WDG_CLK_HSYNC_FALLING,
  HAL_GFXTIM_WDG_CLK_VSYNC_RISING,
  HAL_GFXTIM_WDG_CLK_VSYNC_FALLING,
  HAL_GFXTIM_WDG_CLK_TE_RISING,
  HAL_GFXTIM_WDG_CLK_TE_FALLING,
  HAL_GFXTIM_WDG_CLK_EVENT_1,
  HAL_GFXTIM_WDG_CLK_EVENT_2,
  HAL_GFXTIM_WDG_CLK_EVENT_3,
  HAL_GFXTIM_WDG_CLK_EVENT_4
} hal_gfxtim_wdg_clk_src_t;

Related concepts:


HAL GFXTIM watchdog hardware reload options constants

HAL1

HAL2

In HAL1, the watchdog hardware reload is member of GFXTIM_WatchdogConfigTypeDef. It provides all possible watchdog external triggers interconnections.

#define GFXTIM_WATCHDOG_HW_RELOAD_DISABLE
#define GFXTIM_WATCHDOG_HW_RELOAD_FALLING_EDGE
#define GFXTIM_WATCHDOG_HW_RELOAD_RISING_EDGE

Removed; In HAL2,these constants are no longer available, as all reserved bit fields have been omitted from implementation.